home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / wb / czesc_1 / dropit! / englishdocs / dropit!.doc < prev    next >
Text File  |  1994-08-08  |  18KB  |  466 lines
  1.  
  2. *** DropIt! v0.98 (August, 8th 1994) ***
  3. *** by Jean-Yves Oberlé              ***
  4.  
  5. 0.Summary
  6.  
  7.   1.Introduction
  8.  
  9.   2.Installation
  10.  
  11.     2.1.Installation by Installer
  12.  
  13.     2.2.Installation by IconX
  14.  
  15.   3.Directions for use
  16.  
  17.     3.1.First contact with DropIt!
  18.  
  19.     3.2.Setting of DropIt! preferences
  20.  
  21.       3.2.1.Setting of DropIt! own preferences
  22.  
  23.       3.2.2.Setting of files preferences
  24.  
  25.       3.2.3.Other gadgets
  26.  
  27.   4.Errors
  28.  
  29.     4.1.Errors occurring while DropIt! is starting
  30.  
  31.     4.2.Errors occurring while DropIt! is running
  32.  
  33.   5.History
  34.  
  35.   6.Copyright
  36.  
  37.  
  38. 1.Introduction
  39.  
  40.     DropIt! has been written in order to make the "exploration" of the
  41.   public domain disks easier. More often than not, those disks contain
  42.   numerous files which examination needs the use of quite a lot of dif-
  43.   ferent utilities (ILBM reader, text viewer, archive utility, ...).
  44.   DropIt! enables you to do this automatically.
  45.  
  46.     To this end, it opens when it is started an icon on the Workbench
  47.   screen on which you can put another icon. The type of the file is then
  48.   recognized automatically and the associated program (chosen by the
  49.   user) started (an ILBM reader for an image for instance).
  50.  
  51.     DropIt! can only be run under Kickstart v2.04 (or higher). It needs
  52.   the whatis library (in the LIBS: directory) and the DropIt!Handler fi-
  53.   le (in the L: directory) (these two files are copied by the installa-
  54.   tion scripts).
  55.  
  56.  
  57. 2.Installation
  58.  
  59.     The installation can be done by Installer or by IconX.
  60.  
  61.  
  62. 2.1.Installation by Installer
  63.  
  64.     You must have the Commodore Installer program. If so, just click
  65.   twice on the "Install.installer" icon.
  66.  
  67.     The installation script will act as described below :
  68.  
  69.       1) a DropIt! directory is created;
  70.  
  71.       2) the DropIt! file is copied into this directory;
  72.  
  73.       3) the DropIt! handler is copied into the L: directory;
  74.  
  75.       4) the whatis library is copied into the LIBS: directory;
  76.  
  77.       5) the Utilities directory is created and the utilities Decrunch,
  78.          PlaySample, ShowILBM, and ShowText are copied into it (you can
  79.          have a look at documentations of these programs to learn more
  80.          about them). The powerpacker library is also copied into the
  81.          LIBS: directory (it is used by Decrunch);
  82.  
  83.       6) the Icons directory is created and some icons useful to DropIt!
  84.          are copied into it;
  85.  
  86.       7) the DropIt! preferences file is created in the ENV: and ENVARC:
  87.          directories;
  88.  
  89.       8) The Examples directory is created and some files (sounds, pic-
  90.          tures and texts) are copied into it. They enable you to test
  91.          DropIt! quickly;
  92.  
  93.       9) the Docs directory is created and the documentations of the
  94.          following programs are copied into it : DropIt!, Decrunch,
  95.          PlaySample, ShowILBM and ShowText.
  96.  
  97.     If 'Intermediate User' or 'Expert User' installation mode is chosen,
  98.   the user will be asked to confirm the 5, 6, 8 and 9 actions.
  99.  
  100.     If 'Expert User' installation mode is chosen, the user will be able
  101.   to choose another destination directory (DropIt! by default in the
  102.   other modes).
  103.  
  104.     In the case of the 'Novice User' mode, the user is never asked for
  105.   any confirmation.
  106.  
  107.  
  108. 2.2.Installation by IconX
  109.  
  110.     You should use this installation if you don't have Installer. The
  111.   script is started by clicking twice on the "Install.iconx" icon. It
  112.   acts as described above.
  113.  
  114.  
  115. 3.Directions for use
  116.  
  117. 3.1.First contact with DropIt!
  118.  
  119.     Once DropIt! is installed, you just have to click twice on its icon
  120.   to launch it (of course, it can also be started by using the Shell).
  121.   DropIt! then opens an icon on the Workbench screen. Dragging and drop-
  122.   ping another icon on it will lead DropIt! to start the associated pro-
  123.   gram (an ILBM reader for an image for instance). This program can of
  124.   course be defined by the user.
  125.  
  126.     If you have installed the four little utilities (Decrunch, PlaySam-
  127.   ple, ShowILBM and ShowText), you can test DropIt! now. Just drop the
  128.   icons from the Examples directory on the DropIt! icon and look at the
  129.   result (or listen to it).
  130.  
  131.     You would probably like to use more powerful utilities (Mostra for
  132.   example). To do this, you'll have to learn how to set DropIt! prefe-
  133.   rences.
  134.  
  135.  
  136. 3.2.Setting of DropIt! preferences
  137.  
  138.     Setting of DropIt! preferences is done through clicking twice on its
  139.   icon. DropIt! thus opens a window like the following one :
  140.  
  141.    --------------------------------------------------------------------
  142.   |O| Preferences : DropIt!                                        |O|O|
  143.    --------------------------------------------------------------------
  144.   |                                                                    |
  145.   |  Language   Icon type                          Icon image          |
  146.   |                                                                    |
  147.   | x English   o Window                  - -------------------------  |
  148.   | o Français  x Icon              Name |O|                         | |
  149.   |                                       - -------------------------  |
  150.   |                                         -----     ----   --------  |
  151.   |                                      X |   0 | Y |  0 | |  Test  | |
  152.   |                                         -----     ----   --------  |
  153.   |                              Files                                 |
  154.   |        Types                                                       |
  155.   |  ---------------- -                   ---------------------------  |
  156.   | | Volume         |O|     Description |                           | |
  157.   | | Assign         |O|                  ---------------------------  |
  158.   | | Dir            |O|                  - -------------------------  |
  159.   | | Exe            | |         Program |O|                         | |
  160.   | | Pure Exe       | |                  - -------------------------  |
  161.   | | PP40 Exe       | |                  - -----------        ------  |
  162.   | | PP30 Exe       | |      Start from |O| Workbench | Stack | 4096| |
  163.   | | PP Exe         | |                  - -----------        ------  |
  164.   | |*Script         |-|                  ---------------------------  |
  165.   | |*Text           |-|         Command |                           | |
  166.   |  ---------------- -                   ---------------------------  |
  167.   |       --------                                                     |
  168.   |      | Remove |                                                    |
  169.   |       --------                                                     |
  170.   |  --------          ---------           --------          --------  |
  171.   | |  Save  |        |   Use   |         |  Quit  |        | Cancel | |
  172.   |  --------          ---------           --------          --------  |
  173.    --------------------------------------------------------------------
  174.  
  175.     This window enables you to define two kinds of settings : setting of
  176.   DropIt! own preferences and setting of files preferences.
  177.  
  178.  
  179. 3.2.1 Setting of DropIt! own preferences
  180.  
  181.     Several settings are available.
  182.  
  183.     The Language gadget enables you to choose the DropIt! language. For
  184.   the moment, only English and French are available. If the locale li-
  185.   brary is present, DropIt! will set the language by itself.
  186.  
  187.     The Icon type gadget makes it possible for you to choose between the
  188.   opening of a window or of an icon at DropIt! start. The main differen-
  189.   ce is, from the user point of view, the absence of a name under the
  190.   window. So the user can put it in the bottom right corner of the Work-
  191.   bench screen in order to make easier the quick drop of icons on it.
  192.  
  193.     The Name gadget enables you to replace the default icon image by
  194.   your own image. You must give the access path to an ILBM file. If pos-
  195.   sible, this image should be compatible with the Workbench screen dis-
  196.   play mode. If it is not the case, the image will be displayed all the
  197.   same. But its shape and its colors might change (in the case of a HAM
  198.   picture for instance).
  199.  
  200.     Thanks to the X and Y gadgets, you can give the abscissa and the or-
  201.   dinate of the DropIt! icon provided that its type is window.
  202.  
  203.     Finally, the Test gadget enables you to have a look at a new icon.
  204.   Clicking on this gadget leads DropIt! to open a new icon taking the
  205.   type (Icon type gadget), the picture (Name gadget) and the position in
  206.   the case of a window (X and Y gadgets) into account. This icon can of
  207.   course be moved to assign a new position to it. Clicking twice on it
  208.   will close the icon. If the type window has been chosen, the new posi-
  209.   tion is written in the X and Y gadgets.
  210.  
  211.  
  212. 3.2.2.Setting of files preferences
  213.  
  214.     This paragraph describes how to define the programs that will be
  215.   started according to the type of the icon dropped on the DropIt! icon.
  216.  
  217.     First, the type of file must be chosen in the Types gadget list.
  218.   When this is done, the type name appears in the Description gadget.
  219.  
  220.     Then, you have to choose the program associated with this type by
  221.   giving its access path in the Program gadget.
  222.  
  223.     The Start from gadget makes it possible to decide whether DropIt!
  224.   should imitate the Workbench or the CLI to start the program. In the
  225.   second case, if the program generates some text output, DropIt! will
  226.   open a window where it will be displayed. This window will not be clo-
  227.   sed automatically. This has to be done by the user.
  228.  
  229.     The Stack gadget enables you, as you would have guessed it, to defi-
  230.   ne the size of the stack for the program. The size should never be
  231.   less than 4000 bytes. If you give a smaller size than the one indica-
  232.   ted by the .info icon file (if it exists), DropIt! will choose this
  233.   last value to avoid a program crash.
  234.  
  235.     Thanks to the Command gadget, you can define the command line used
  236.   to start the program from the CLI. This line must not include the pro-
  237.   gram name. On the other hand, it could include (only once) the key-
  238.   word <file name>. This key-word will be replaced by the file name (in-
  239.   cluding the access-path) when the program is started.
  240.  
  241.     Let's take an example to understand better how to associate a pro-
  242.   gram with a type. We would like Virus_Checker to scan executable files
  243.   dropped on the DropIt! icon.
  244.  
  245.     We first have to choose the right type. This is done by clicking on
  246.   the Exe type in the Types gadget list. This type appears immediately
  247.   in the Description gadget.
  248.  
  249.     In the Program gadget, we indicate the access path to Virus_Checker:
  250.  
  251.       Hard Disk:Utilities/Virus_Checker
  252.  
  253.     We want the program to be started from the CLI. So we have to click
  254.   once on the Start from gadget.
  255.  
  256.     For the stack size, we should at least indicate 4096 in the Stack
  257.   gadget.
  258.  
  259.     In the Command gadget, we write :
  260.  
  261.       -q <file name>
  262.  
  263.     (the -q option tells Virus_Checker to exit after having scanned the
  264.     file).
  265.  
  266.     Finally, we click on the Use gadget to tell DropIt! to take our new
  267.   preferences into account.
  268.  
  269.     If we now put the SYS:System/Format icon on the DropIt! icon, the
  270.   generated command line will be :
  271.  
  272.     "Hard Disk:Utilities/Virus_Checker" -q "SYS:System/Format".
  273.  
  274.   Virus_Checker will thus examine the Format file.
  275.  
  276.     A star will appear in front of the Exe type. This means that this
  277.   type has been taken into account by DropIt!.
  278.  
  279.     When you enter a string in the Program, Command or Name gadgets, you
  280.   must always end with a carriage return. Otherwise, the new string
  281.   might not be taken into account by DropIt!.
  282.  
  283.  
  284. 3.2.3. Other gadgets
  285.  
  286.     The DropIt! window contains five other gadgets that have not been
  287.   described yet.
  288.  
  289.     The first of them is Remove. It deletes the link between a type and
  290.   its associated program. You just have to choose the type and to click
  291.   on the gadget. The Description, Program, Start from, Stack and Command
  292.   gadgets will not be affected. Only the star in front of the type will
  293.   disappear. This enables you to recover datas after an accidental remo-
  294.   ve. You just have to select the Program gadget (for instance) and
  295.   press the enter key.
  296.  
  297.     The Save gadget makes it possible for you to record the preferences.
  298.   The new preferences are immediately taken into account.
  299.  
  300.     A click on the Use gadget records temporarily the preferences (until
  301.   the next reset of your Amiga). The new preferences are immediately ta-
  302.   ken into account.
  303.  
  304.     A click on the Quit gadget leads DropIt! to exit. No record is done.
  305.  
  306.     Finally, the Cancel gadget enables you to close the preferences win-
  307.   dow. No record is done. The DropIt! icon remains on the Workbench
  308.   screen.
  309.  
  310.     You should notice that when the preferences window is open, the
  311.   DropIt! icon remains active. You can still go on dropping icons on it.
  312.   That's also true when the second icon is open (the one opened by the
  313.   Test gadget).
  314.  
  315.     If a project file which type is unknown (or has not been associated
  316.   with a program) is dropped on the DropIt! icon, DropIt! will try to
  317.   start the icon default tool.
  318.  
  319.  
  320. 4.Errors
  321.  
  322.     Errors can occur while DropIt! is starting or running.
  323.  
  324. 4.1.Errors occurring while DropIt! is starting
  325.  
  326.     When an error occurs while DropIt! is starting, the following messa-
  327.   ges may appear :
  328.  
  329.     "Can't open intuition library v37" :
  330.  
  331.       The intuition library version 37 (or higher) is not available. You
  332.       should use a more recent Kickstart version (at least 2.04).
  333.  
  334.     "Can't open dos library v37" :
  335.  
  336.       The dos library version 37 (or higher) is not available. You
  337.       should use a more recent Kickstart version (at least 2.04).
  338.  
  339.     "Can't open graphics library v37" :
  340.  
  341.       The graphics library version 37 (or higher) is not available. You
  342.       should use a more recent Kickstart version (at least 2.04).
  343.  
  344.     "Can't open workbench library v37" :
  345.  
  346.       The workbench library version 37 (or higher) is not available. You
  347.       should use a more recent Kickstart version (at least 2.04).
  348.  
  349.     "Can't open iffparse library v37" :
  350.  
  351.       The iffparse library version 37 (or higher) is not available. You
  352.       should use a more recent Workbench version (at least 2.04).
  353.  
  354.     "Can't open gadtools library v37" :
  355.  
  356.       The gadtools library version 37 (or higher) is not available. You
  357.       should use a more recent Kickstart version (at least 2.04).
  358.  
  359.     "Can't open asl library v37" :
  360.  
  361.       The asl library version 37 (or higher) is not available. You
  362.       should use a more recent Workbench version (at least 2.04).
  363.  
  364.     "Can't open icon library v37" :
  365.  
  366.       The icon library version 37 (or higher) is not available. You
  367.       should use a more recent Kickstart version (at least 2.04).
  368.  
  369.     "Can't open whatis library v3" :
  370.  
  371.       The whatis library version 3 (or higher) is not available. Check
  372.       if this library is in the LIBS: directory. If that is the case,
  373.       you should try to get a more recent version.
  374.  
  375.     "Out of memory" :
  376.  
  377.       DropIt! needs more memory. Try to free some by closing some appli-
  378.       cations or windows and start DropIt! again.
  379.  
  380.     "Cannot allocate a signal" :
  381.  
  382.       No more signals are available. If DropIt! has been started from
  383.       the CLI, try to start it from the Workbench.
  384.  
  385.     "No notification available" :
  386.  
  387.       The filesystem managing the ENV: directory doesn't allow notifica-
  388.       tion. Assign ENV: to a directory on the ram disk.
  389.  
  390.     "No information on Workbench screen" :
  391.  
  392.       DropIt! can't get information on the Workbench screen because the-
  393.       re isn't enough memory. Try to free some.
  394.  
  395.     "Cannot start handler" :
  396.  
  397.       DropIt! cannot load and start its handler. Check if the handler
  398.       (DropIt!Handler) is in the L: directory.
  399.  
  400.     "Cannot create an icon" :
  401.  
  402.       DropIt! cannot open an icon on the Workbench screen. Check if the
  403.       Workbench has been loaded (by looking for icons on its screen). If
  404.       that is the case, there's probably not enough memory available.
  405.       Try to free some.
  406.  
  407.     "Cannot open a window" :
  408.  
  409.       DropIt! cannot open a window on the Workbench screen. Check if the
  410.       Workbench has been loaded (by looking for icons on its screen). If
  411.       that is the case, there's probably not enough memory available.
  412.       Try to free some.
  413.  
  414.     "Type of screen not handled" :
  415.  
  416.       DropIt! cannot open icons on Dual-playfield, HAM or Extra Half
  417.       Brite screens.
  418.  
  419.  
  420. 4.2 Errors occurring while DropIt! is running
  421.  
  422.      These errors simply lead DropIt! to flash the screen. They may be
  423.    caused by :
  424.  
  425.      - a lack of memory,
  426.  
  427.      - an unknown type of file dropped on the DropIt! icon,
  428.  
  429.      - the impossibility to save the preferences,
  430.  
  431.      - ...
  432.  
  433.  
  434. 5.History
  435.  
  436.     08.08.94 : first released version (0.98) of DropIt!
  437.  
  438.  
  439. 6.Copyright
  440.  
  441.     DropIt! is a freeware. This means that it is copyright by Jean-Yves
  442.   Oberlé but it may be freely distributed provided that :
  443.  
  444.       - all the files described in the ReadMe file are included in the
  445.         distribution;
  446.  
  447.       - no file is modified;
  448.  
  449.       - it is not sold at a too high price (not more than the media, the
  450.         duplicate and the postage cost for a disk distribution for ins-
  451.         tance).
  452.  
  453.     The author reserves the right to prohibit anybody that does not res-
  454.   pect the above rules from distributing his programs.
  455.  
  456.     No guarantee of any kind is given that the programs are reliable.
  457.   The author cannot be made responsible for any damage which is caused
  458.   by the use of his programs.
  459.  
  460.     For any suggestions, bug reports, ... you can write to the author :
  461.  
  462.                             Jean-Yves Oberlé
  463.                             14, rue Christine de Saxe
  464.                             67170 Brumath
  465.                             France
  466.